home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / pcxbgi1.exe / PCX2BGI.DOC < prev    next >
Encoding:
Text File  |  1991-03-03  |  11.1 KB  |  224 lines
  1.  
  2.  
  3.                           HOW TO USE PCX2BGI.EXE
  4.                        By Marty Balash, Waterbury CT
  5.                               PCLINK: MarBal
  6.                                  03/03/91
  7.  
  8.                        FOR TURBO C AND TURBO PASCAL
  9.  
  10.           A GRAPHICS UTILITY FOR DISPLAYING .PCX and .LBM FORMAT FILES
  11.               CONVERTS ALL OR PART OF PICTURE TO BGI IMAGE FORMAT
  12.  
  13.    * Directly reads Deluxe Paint and PC Paintbrush pictures and saves them
  14.      as .MJB files (which are BGI images with a 28-byte header attached.)
  15.      A utility is provided to remove the header, if desired.
  16.    * Graphics created with paint programs can be easily displayed
  17.      by Turbo C and Turbo Pascal programs.
  18.    * A program using bitmapped graphics is as easy as opening a graphics
  19.      screen, reading a file, and using PutImage.
  20.    * Great for games, animations or any application.
  21.    * Turbo C programmers can hard-code smaller graphics into their programs
  22.      without needing external graphics files. C-code generation utility and
  23.      sample program provided.
  24.    * Shareware - Only $15.00!
  25.        Send To:
  26.          Marty Balash
  27.          2 Pinecrest Drive
  28.          Prospect CT  06712
  29.  
  30.  ***************************************************************************
  31.  * IMPORTANT - READ THIS:                                                  *
  32.  *   Use this software at your own risk.  I assume no responsibility for   *
  33.  *   any type of losses or difficulties of any kind that you encounter,    *
  34.  *   directly or indirectly, as a result of using these programs. They     *
  35.  *   have been tested only by me on my computer with compilers configured  *
  36.  *   to my preferences.                                                    *
  37.  *   These programs (except for the Pascal) were written for my personal   *
  38.  *   use, and I decided to release them as shareware.                      *
  39.  *   Please send me $15.00 if you find them useful.                        *
  40.  *   -  Deluxe Paint is a registered trademark of Electronic Arts, Inc.    *
  41.  *   -  PC Paintbrush is a registered trademark of Z-Soft, Inc.            *
  42.  *   -  Turbo C, Turbo Pascal and BGI are registered trademarks of Borland *
  43.  *      International, Inc.                                                *
  44.  ***************************************************************************
  45.  
  46. TUTORIAL - Saving Part Of A Picture To Disk
  47.    o - Start the program with the supplied demo picture:
  48.        PCX2BGI MOUTHS.PCX <Enter>
  49.    o - Wait for the picture to load, press any key when message comes up.
  50.    o - Press <Enter> to select "Partial Screen" save.
  51.    o - MOUTHS.PCX will be displayed on the screen with a white "corner-
  52.        shaped" cursor in the upper left area of the screen.
  53.          - Try pressing the "C" key to change the color of the cursor and
  54.            status line (on the bottom of the screen).
  55.          - Press the "X" key to view the help screen.
  56.            Press any key except "C" to return to framing your image.
  57.          - Press the space bar to change the cursor speed and notice
  58.            that "Speed:" on the status line shows the current speed.
  59.        Use the cursor keys to move the cursor to the upper-left region
  60.        of the area you want to save. Press <Enter> after you have selected
  61.        the upper-left corner.
  62.    o - The cursor has changed to a rectangle. Move the lower-right corner of
  63.        the rectangle to the lower-right region of the area you want to save.
  64.        Use the spacebar to change the cursor speed. Press <Enter> when you
  65.        have framed the image you want to save.
  66.   o - When prompted for a filename, type:
  67.           MYTEST1 <Enter>
  68.        This will create a file called MYTEST.MJB.
  69.          Note: You could have left the filename blank if you didn't want to
  70.                save.
  71.          Note: Existing files won't be written over until you verify that you
  72.                want to do so.
  73.    o - When prompted "Select Another Image From Same Screen? (Y/N)", press
  74.        "N" to quit the program. You could continue working with the same
  75.         picture by entering "Y" at this prompt.
  76.    o -  View the image you just saved:
  77.           SHOWMJB MYTEST1.MJB <Enter>
  78.         SHOWMJB.C is in the zipped file for Turbo C programmers. The zipped
  79.         for Turbo Pascal programmers contains two TP demos.
  80.  
  81. TUTORIAL - Saving A Whole Picture To Disk
  82.    o - Start the program with the supplied demo picture:
  83.        PCX2BGI MOUTHS.PCX <Enter>
  84.    o - Wait for the picture to load, press any key when message comes up.
  85.    o - Press the spacebar to move the arrow to "Full Screen".
  86.    o - Press <Enter> to select "Full Screen" save.
  87.    o - MOUTHS.PCX will be displayed on the screen until you press a key.
  88.    o - When prompted for a filename, type:
  89.            MYTEST2 <Enter>
  90.    o - When prompted "Select A Partial Image From This Screen? (Y/N)", press
  91.        "N" to quit the program.
  92.    o -  View the image you just saved:
  93.           SHOWMJB MYTEST2.MJB <Enter>
  94.  
  95. NOTE ON USING PCX2BGI "PARTIAL SCREEN":
  96.     o - When framing a partial image from a screen, the bottom-most part
  97.         of the screen is not available, because of the status line.
  98.         A full-screen save will always save this part of the screen.
  99.         Don't draw any graphics down there if you plan on using a
  100.         partial save to get them.
  101.     o - The 11th color of the picture palette is being used for the cursor
  102.         and status line. The "C" key changes the color, but the not the
  103.         palette position of the cursor and status line (it's always the 11th
  104.         color in the palette). The image being displayed and the image
  105.         being saved use the original 11th color after exiting this
  106.         screen.
  107.     o - Use the coordinates on the status line when working. By making
  108.         a note of where the image was when you picked it up, you can
  109.         place it in exactly the same place from your program - just use
  110.         the (status line) X and Y coordinates in PutImage.
  111.         If you need to save similar images and want them all to be the
  112.         same size, note the coordinates before you press <Enter> the
  113.         second time.
  114.     o - If you make a mistake framing your image:
  115.         Keep pressing <Enter> until you return to picture screen
  116.         again, with the cursor in the upper left corner. The cursor
  117.         will be the same color as last time.
  118.         Pressing <Enter> at the filename prompt will not save the image
  119.         you just framed, and pressing <Enter> at the "Another Image?"
  120.         prompt will assume you mean "Y".
  121.  
  122. NOTE ON LOADING .LBM PICTURES:
  123.          They load slow. It doesn't affect the saved .MJB image.
  124.  
  125. WHAT FILES TO USE:
  126.    o -  Turbo C programmers should unzip the file TC.ZIP first.
  127.    o -  Turbo Pascal programmers should unzip the file TP.ZIP first.
  128.    o -  Programmers should look through both zip files, TC.ZIP and TP.ZIP,
  129.         no matter what language they normally use.
  130.         -  C programmers might want to look at TPDEMO2.PAS for a rough
  131.            demo of animation.
  132.         -  Pascal programmers might want to look at SHOWMJB.C or CYCLE.C
  133.            (at least the comments) to see how to load a full screen image,
  134.            since I haven't included any Pascal code to do that.
  135.  
  136.    Programming Tips:
  137.       *  A quick way to clear an area of the screen is to
  138.          draw a solid rectangle, the same color as the
  139.          background, over the area.
  140.       *  If an object is too big to save in one "Partial
  141.          Save", save it in two adjacent images. When
  142.          it's positioned on the screen, you can't tell that
  143.          the object is made up of two images.
  144.       *  Use the program TPCONV.EXE in the TP.ZIP file to
  145.          create header files containing palettes from
  146.          various pictures. These 28-byte header files can be
  147.          loaded for the purpose of alternating color palettes
  148.          while displaying images.
  149.       *  If you don't like the 28-byte header on the
  150.          .MJB files, TPCONV.EXE extracts the header and
  151.          and data, leaving plain BGI data ("Putimage" format).
  152.       *  CYCLE.C demonstrates color cycling, a nice effect.
  153.          A graphic is provided for use with it (CYCLE.LBM).
  154.          To see it run, compile CYCLE.C with Turbo C and
  155.          convert CYCLE.LBM to a Full Screen MJB image using
  156.          PCX2BGI.  Turbo Pascal programmers may be interested
  157.          in the source to find out how to load a full screen
  158.          image and how to color cycle.
  159.  
  160. LAST MINUTE BUG NOTICED:
  161.   If you try to save a partial image longer than about 550 pixels
  162.   across, it won't save.
  163.  
  164.  
  165. Files in PCX2BGI.ZIP:
  166. PCX2BGI  DOC  - Documentation for PCX2BGI.EXE
  167. PCX2BGI  EXE  - Converts pictures to BGI images
  168. SHOWMJB  EXE  - Shows a MJB file.  Source in TC.ZIP
  169. MOUTHS   PCX  - A picture with images to try out
  170. LETTERS  PCX  - Another picture to experiment with
  171. TC       ZIP  - For Turbo C users
  172. TP       ZIP  - For Turbo Pascal users
  173.  
  174.  
  175. *END OF FILE*
  176.  
  177.  
  178.          ----------------end-of-author's-documentation---------------
  179.  
  180.                          Software Library Information:
  181.  
  182.                     This disk copy provided as a service of
  183.  
  184.                            Public (software) Library
  185.  
  186.          We are not the authors of this program, nor are we associated
  187.          with the author in any way other than as a distributor of the
  188.          program in accordance with the author's terms of distribution.
  189.  
  190.          Please direct shareware payments and specific questions about
  191.          this program to the author of the program, whose name appears
  192.          elsewhere in  this documentation. If you have trouble getting
  193.          in touch with the author,  we will do whatever we can to help
  194.          you with your questions. All programs have been tested and do
  195.          run.  To report problems,  please use the form that is in the
  196.          file PROBLEM.DOC on many of our disks or in other written for-
  197.          mat with screen printouts, if possible.  PsL cannot debug pro-
  198.          programs over the telephone, though we can answer questions.
  199.  
  200.          Disks in the PsL are updated  monthly,  so if you did not get
  201.          this disk directly from the PsL, you should be aware that the
  202.          files in this set may no longer be the current versions. Also,
  203.          if you got this disk from another vendor and are having prob-
  204.          lems,  be aware that  some files may have become corrupted or
  205.          lost by that vendor. Get a current, working disk from PsL.
  206.  
  207.          For a copy of the latest monthly software library newsletter
  208.          and a list of the 3,000+ disks in the library, call or write
  209.  
  210.                            Public (software) Library
  211.                                P.O.Box 35705 - F
  212.                             Houston, TX 77235-5705
  213.  
  214.                                 1-800-2424-PSL
  215.                              MC/Visa/AmEx/Discover
  216.  
  217.                           Outside of U.S. or in Texas
  218.                           or for general information,
  219.                               Call 1-713-524-6394
  220.  
  221.                           PsL also has an outstanding
  222.                           catalog for the Macintosh.
  223.  
  224.